Multimedia Selection

home *** CD-ROM | disk | FTP | other *** search

/ Multimedia Selection / Multimedia Selection Volume One - CD-ROM / MULTIMEDIA SELECTION____________.ISO / grafica / dos / theimage / theimage.doc < prev next >

Wrap

Text File | 1993-07-30 | 13.1 KB | 325 lines

T h e I m a g e --------------- Version 1.00 Released July 31th, 1993 Copyright (C) 1993 by José De Almeida. All Rights Reserved. P.O.Box 4185. 1504 Lisboa Codex. Portugal. --- COPYRIGHT NOTICE --- TheImage is Copyright (C) 1993 by José De Almeida. TheDraw is Copyright (C) 1986-1993 by TheSoft Programming and Ian E. Davis. Turbo Pascal is Copyright (C) 1983-1992 by Borland International, Inc. TheImage, its accompanying documentation, have been released as Shareware, but it is not Freeware or Public Domain software. If you find this program usefull to you, and you plan to use it after 15 days of evaluation period, you must send me US $5 dolars, which will be pretty much appreciated. All contributions will help me keeping on developping shareware and freeware programs. See bellow for mail address. No part of TheImage may be modified, altered, reverse engineered, sold, or distributed in any form which would involve some sort of trade without prior written permission from the Author. --- REGISTER --- After 15 days evaluation peridod, if you find this program usefull, and you plan to use it in future, a $5 contribution is required. Send your money payable to José De Almeida, to the following address: ■ José De Almeida P.O.Box 4185 1504 Lisboa Codex Portugal Please specify your name and address. Be sure, I'll apreciate it very much ! Thanks in advance. --- DISCLAIMER --- This program is provided "as is" without warranty of any kind. In addition, the Author specifically disclaims all warranties, expressed or implied, including but not limited to implied warranties of merchantability and fitness for a particular purpose and TheImage license granted herein in particular, and without limiting operation of TheImage gram license with respect to any particular application, use, or purpose. In no event shall the Author be liable for any loss of profit, lost savings, commercial damage, or other incidental or consequential damages arising out of the use or inability to use TheImage even if the Author, José De Almeida, or an authorized distributor of TheImage has been advised of the possibility of such damages, or for any claim by any other party. --- LICENSE --- As any Shareware program, you may freely distribute TheImage, subject to the following restrictions: ■ TheImage must be distributed in an unmodified form, including the TheImage documentation file and description file FILE_ID.DIZ. Particularly, SysOps MUST keep inside the archive the original FILE_ID.DIZ description file, as it is distributed by the Author. This will give BBS users the correct and same good description for all BBS users over the world. ■ TheImage may not be included with any other product for any reason whatsoever without prior written consent from José De Almeida. ■ No charge or payment may be accepted for TheImage, without written permission from the Author. Bulletin Board System Operators may post TheImage on their BBS for downloading by their users without written permission, only if the above conditions are met, and only if no special fee is necessary to access TheImage files (a general fee to access the BBS is acceptable). Distributors of Shareware and Public Domain software MUST obtain written permission from José De Almeida before distributing TheImage and must follow the above conditions. Permission is almost always granted; this requirement is necessary to ensure protection for the Author and users of TheImage from unscrupulous individuals. --- CUSTOMER SUPPORT --- Full support to users of TheImage is available through one major channel. If you wish contact the Author with questions, suggestions, problems, or other comments: ■ Call the TheImage's worldwide support Bulletin Board System: THE IMAGE BANK BBS ------------------- SysOp: Jose Almeida Node #1: +351-1-7786640 * 20-07h (7 days a week) Intel SatisFAXtion Modem /400e * 14.4k * V.32bis RIME site: ->TIB (or #5314) Mail address: P.O.Box 4185. 1504 Lisboa Codex. Portugal. Here I can be reached in the following conference: (LOCAL): SUPPORT RIME : SYSOPS : COMMON --- FILES INCLUDED --- The TheImage is distributed in a archive ZIP file. Please do not change the archive contents or add any file. The archive name is THEIMAGE.ZIP, and contains the following files: ■ THEIMAGE.EXE - The program ■ THEIMAGE.DOC - The documentation ■ HISTORY.DOC - Version history ■ FILE_ID.DIZ - Description file for PCBoard systems (please do not delete or change this file; this file provides the Author's description of the archive) ■ DEMO.EXE - Demo program on how to use TheImage and a TheDraw .ASM file ■ DEMO.PAS - Source code for the demo program ■ DEMO_IMG.ASM - .ASM file of the demo program screen image, generated by The Draw ■ DEMO_IMG.PAS - .PAS file of the demo program screen image, converted by TheImage ■ DEMO_IMG.TD - Original TheDraw file for the demo program screen image ■ THEDRAW.PAS - Almost the original UNCRUNCH.PAS file bundled in TheDraw; I have implemented it as a full TP unit ■ SOFTWARE.DOC - The complete list, along with brief description of all my Shareware and Freeware programs --- PROGRAM DESCRIPTION --- There isn't really nothing much to say about TheImage. TheImage generates Turbo Pascal .PAS complete source code Unit, from a TheDraw screen image previously saved as .ASM assembler file, ready to be compiled by TP as CODE (not DATA), and used in your programs. The resulting source code Unit .PAS file can be directly used in your programs, and compiled by Turbo Pascal as plain CODE (not DATA), using the USES statement. I can't remember in which exactly version Turbo Pascal started to accept real Assembler code mixed up with Pascal source, but I think it was version 5.5. So, if this is true, you can use TheImage in all Turbo Pascal versions released after and including version 5.5. I did TheImage back in April 1991. At that time, TheImage was called ASM2TPU, a name I never liked. I'm using this program since then. Almost all my programs used TheImage. The sintax of TheImage is quite simple: THEIMAGE filename[.ASM]...filename[.ASM] You must pass at least a parameter, but as long as is TheImage concern, you may pass as many parameters as you want. Zillions. However, DOS has its limits, so, don't you ever forget them <g>. Each parameter must represent a filename. You may specify drive and path, as long as it is recognized by DOS. And, as long it is, TheImage will recognized it. You don't have to specify the file extension. By default, TheImage will add the [.ASM] extension if you don't specify it. You may use wildcards (? and *) in the exactly same way you use them in most of the DOS commands. Here's a sample list of valid commands: THEIMAGE * (means all *.ASM files stored in the current directory) THEIMAGE *.ASM (means exactly the same thing as the previous example) THEIMAGE C:\TP\*.ASM (means all the .ASM files stored in the C:\TP directory) THEIMAGE * C:\TP\* (means all the .ASM files stored in the current directory, and all the .ASM files stored in the C:\TP directory) THEIMAGE *.ASM C:\TP\*.ASM (means exactly the same thing as the previous example) THEIMAGE C:\TP\* D:\MYPROG1\*.ASM * E:\MYPROGS\MYPROG2\*.ASM (menas all the .ASM files stored in the C:\TP directory, plus all the files stored in the D:\MYPROG1 directory, plus all the .ASM files stored in the current directory, plus all the .ASM files stored in the E:\MYPROGS\MYPROG2 directory) Each filename you specify must be a TheDraw .ASM file. Do not change the file contents, or TheImage may return an error. In order to explain how TheImage works, let me assume you are going to write a program (the final step, is not the easiest step, at least in this case...). I'll use the files I have included in this package, as an example. But first, take a look on the contents of the DEMO_IMG.ASM and DEMO_IMG.PAS files. It will help you understand how are things are done. First, you design the screen image. Run TheDraw. Refer to TheDraw documention on how this wondefull utility works. After the screen image being finished, save it [ALT-S] as a TheDraw file (DEMO_IMG.TD). Without quiting TheDraw, save it also as an .ASM file (DEMO_IMG.ASM). Remember this: TheImage supports the entire screen image, or a region block of the screen. After giving the adequate command, TheDraw will ask you the following question: "Save mode ? (Crunched, Ascii [no colors], or Normal)" You may answer either Crunched or Normal. TheImage supports both modes. Allways use the Crunch mode, since TheDraw will compress the image data, in order to take less CODE space. So, it will reduce your final .EXE file. TheDraw will then ask you another question: "Reference identifier to use? (IMAGEDATA)" By default, TheDraw will use the IMAGEDATA identifier, if you simply press the [ENTER] key. This will by the identifier prefix names for all variables TheDraw will save on file, and also the name TheImage will give to the procedure (where the screen image will be stored) as well as related variable names, when it converts the file to .PAS. In the demo example, I have leave it with the default name IMAGEDATA. Next, TheDraw will ask you for the name of the file to be saved. I have answered DEMO_IMG.ASM. Quit TheDraw [ALT-X]. Run the TheImage program using this command: THEIMAGE DEMO_IMG.ASM TheImage will convert this file, and automaticly names it DEMO_IMG.PAS. There is no way, or need (as least I think so), for you to specify the output filename. The file will be always stored in the same directory where the imput .ASM file is located. Look at the DEMO_IMG.PAS file. Particulary notice that the screen image is stored as a PROCEDURE. This is why the screen image doesn't take a single byte of DATA. NEVER, ever, call this PROCEDURE, or your program (and Turbo) will imediately crash. This PROCEDURE is NOT to be called, it's to be used and linked into the .EXE file, if used (which is the hole idea). Ok, now your are in programming mode, so to speak, the last and most hard step of making a program, but the funnyest. Take a look on the DEMO.PAS file. It's a sample demo program for you to understand how to incorporate a TheDraw screen image, converted by TheImage, into your programs. I have included another file THEDRAW.PAS, which is almost the same as is UNCRUNCH.PAS that is distributed along with TheDraw. I have made some minor cosmetic changes, and transformed the file into a full Turbo Pascal unit, for easy use. The THEDRAW.PAS unit have a special INLINE which works real fast. Here's the magic line for displaying the screen image: UnCrunch(Addr(ImageData)^,Mem[Video_Addr:$0000],ImageData_Length); Please read the remarks made by Mr.Ian E. Davis in the THEIMAGE.PAS file. You can find there important information about the displaying of a TheDraw screen image, particulary when you don't want to save the complete screen image, but only a part of it (a box, for instance). TheImage also supports parts of screen images. The process remains the same. But some slight modifications are required. You must calculate the screen address, which is very easy. Refer ton the THEIMAGE.PAS remarks, for further information. And that's it. End of description. --- TOOLS --- This program was written using Borland's Turbo Pascal version 7.0. I also used The The HeartWare Toolkit v2.00 for Turbo Pascal, which is Copyright (C) by José De Almeida & Luis Correia. [end-of-file]